home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (4th Edition) / The Business Master - 4th Edition.iso / files / wordsing / kdqwik / kdcalc.doc < prev    next >
Text File  |  1989-05-25  |  17KB  |  357 lines
  1.  
  2.  
  3.                                 KDCalc            
  4.                     KDCalc Version 7.0  -  May 1989
  5.                  A Product of KD Ranch Enterprises (c)
  6.  
  7.  
  8. GENERAL:
  9.  
  10.     KDCalc is a PC implementation of a simple hand-held calculator with
  11.     a few extended functions thrown in.
  12.  
  13.     It will add, subtract, multiply and divide. It uses an on-screen
  14.     tape, capability to list the tape on a printer and features a nine memory
  15.     register sub-function for storage and recall.  It also has a special
  16.     formula generator allowing entry of complex numeric formulas (like a
  17.     spreadsheet cell). It can be made memory resident.
  18.  
  19.     KDCalc was written in Turbo Pascal 5.0 with the TSR code courtesy of
  20.     my brother-in-law (true), Ken Pottebaum. 
  21.  
  22.  
  23. HISTORY:
  24.  
  25.     Versions 1.0 to 1.7 - Written in BASIC (Not released)
  26.     Versions 3.0 to 3.6 - Written in Turbo Pascal 3.0 (Beta only)
  27.     Versions 4.0 to 4.2 - Written in Turbo Pascal 4.0 (TSR added - Beta tests)
  28.     Versions 5.0 to 6.2 - Written in Turbo Pascal 5.0 (Local releases only)
  29.     Version  7.0        - First Public Release (May 1989)
  30.  
  31.  
  32. COMMAND SYNTAX:
  33.  
  34.     >KDCalc [/M] [/C] [/A] [/L] [/R] [/"x"] [Kxt(at)(ate)] [Fn] [Bn] [Mn]
  35.  
  36.     Believe it or not, with all those parameters, none are required.
  37.  
  38.     Parameters that start with a "/":
  39.  
  40.        All parameters that start with a "/" deal with memory residency.
  41.  
  42.        To make KDCalc memory resident, use the "/M". Assuming that "/M" was
  43.        used, the remaining "/" parameters allow you to define the ACTIVATION
  44.        KEY Combination (Hot-Key). C = Cntl; A = Alt; R = Right Shift;
  45.        L = Left Shift and "x" = any NORMAL key (a-z,0-9). You must use the
  46.        double quotes (") around the NORMAL key.  Any combination of Cntl/
  47.        Alt/Left Shift/Right Shift plus a NORMAL key is OK as long as you use
  48.        only one of each.  EXAMPLES:
  49.  
  50.        >KDCalc /M /C /"C"        Hot-Key is [Cntl][C]
  51.        >KDCalc /a /L /R /"z" /m  Hot-Key is [R Sft][L Sft][Alt][Z]
  52.        >KDCalc /l /c /"3"        No Hot-Key -- you forgot the /M !!!
  53.  
  54.        Hot-Key means press the ACTIVATION KEY combination simultaneously.
  55.        The order and case of these parameters makes no difference, but they
  56.        must be separated by a space.  [Cntl][K] is the default Hot-Key.
  57.  
  58.     Parameters that start with K,F,B or M:
  59.  
  60.        The "K" parameter signifies KeyPad type. The options are:
  61.        Kxt - XT style keypad; Kat - AT style; Kate - Enhanced style.
  62.        This parameter is not really significant -- it only affects the
  63.        display the calculator works the same regardless only the position
  64.        of some of the keys may be a little different.  The AT Enhanced (ate)
  65.        keypad is the default. The keypad layout cannot be changed from
  66.        within the calculator.
  67.  
  68.        The "F" and "B"  parameters define your color choices - foreground
  69.        and background.  Foreground accepts values from 0 - 15, background
  70.        0 - 7.  If any of these numbers are out of range, the default -
  71.        15 (white), 1 (blue) will be used.  These colors can be adjusted
  72.        from within the calculator.
  73.  
  74.       The "M" (mode) parameter controls whether KDCalc starts in "FLOAT" or
  75.       "DOLLAR" mode.  FLOAT is the default.  If you prefer "DOLLAR", use a
  76.       2 as this last parameter -- see FUNCTIONS for explanation of these
  77.       modes. This mode can be changed from inside the calculator.
  78.  
  79.       The K,F,B and M parameters work with both resident and non-resident
  80.       approaches.  Some more EXAMPLES:
  81.  
  82.       >KDCalc  (non-resident,AT enhanced keypad,white on blue,floating decimal)
  83.       >KDCalc f0 m2 b2 kxt  (non-resident,XT keypad,black on green,dollar mode)
  84.       >KDCalc B4 kat /C m2 /"q" /m /L  (resident,Hot-Key=[L Sft][Cntl][Q],
  85.                                         AT keypad,white on red,dollar mode)
  86.  
  87. USAGE:
  88.  
  89.     As I said, the calculator emulates a hand-held version.
  90.     Calculations are entered and performed just like you would
  91.     say them:
  92.  
  93.        You would say,
  94.          "6 plus 5 minus 13 times 4 divided by 2 equals".
  95.        You would enter,
  96.           6 + 5 - 13 * 4 / 2 =    (NOTE: "=" is the ENTER key)
  97.  
  98.     Actually, if you don't know how a cheap hand-held calculator
  99.     works, you probably don't need this program.
  100.  
  101.     The KeyPad shown on the screen is the one you have chosen via the
  102.     command line parameter or, by default, an enhanced keyboard.
  103.     Other keyboards will work the same, only the location of some
  104.     keys may be different.
  105.  
  106.     KDCalc will automatically turn your NumLock and CapsLock on and
  107.     return them to their original state when you exit the program.
  108.     LEAVE THESE KEYS ON WHILE OPERATING THE CALCULATOR.  If for some
  109.     strange reason they are not automatically activated, please turn
  110.     them on.
  111.  
  112. FUNCTIONS:
  113.  
  114.     The screen displays all keys that are active in the boxes 
  115.     somewhere around the keypad display. The H key (help) will
  116.     display a brief description of each key usage. 
  117.  
  118.     I don't plan to explain the white keys from the keypad or
  119.     the specific application of the * / + keys, however
  120.     the following is offered:
  121.  
  122.     Operator Keys: 
  123.        Operator keys cause the calculator to PERFORM AN OPERATION
  124.        affecting the results shown in the display window and/or
  125.        the screen listing.
  126.  
  127.        The keys are: +,*,/,=(ENTER),S and sometimes - and R.
  128.        Also, while they are not strictly "operators", O and C
  129.        will have some similar effects.  You might note that the
  130.        current mathematical operator (+,*,/,-) is always hilighted
  131.        on the keypad display. + is the default operator.
  132.  
  133.     Minus Key (-):
  134.        The minus key has two functions depending on when it is
  135.        hit.  If used directly after any operator, it simply
  136.        becomes part of the next number entered, making it a
  137.        negative number.  Otherwise, it is an operator representing
  138.        the subtraction function.  
  139.  
  140.     Equal Key (= or ENTER):
  141.        Your display will always show the current running total
  142.        after hitting an operator key.  The Equal key will clear
  143.        the display and the running total, setting the current
  144.        total to 0.  Remember, the Equal key is also an operator.
  145.  
  146.     Help (H):
  147.        Opens a window with some very brief help notes about what
  148.        non-number keys do.
  149.  
  150.     Locate (L):
  151.        Moves the calculator on the screen (left,right,center) in
  152.        case it might be covering some data you want to reference.
  153.  
  154.     ForeGround (F) and BackGround (B):
  155.        Each of these keys will "roll" through the available colors for
  156.        their respective areas.  ForeGround will return to 0 after 15 and
  157.        BackGround returns after 7.
  158.  
  159.     Dollar/Float Toggle (D):
  160.        Toggles between Dollar Mode and Float Mode. Dollar mode
  161.        always assumes 2 decimals -- particularly useful to do
  162.        checkbooks and stuff. In Dollar Mode the decimal key is
  163.        disabled. If you hit 123 the display will read 1.23.  Be
  164.        careful of multiply and divide in Dollar Mode (keystrokes
  165.        "123 * 2" will result in 1.23 * .02 -- that result is NOT
  166.        246 -- it will be 0.02). I recommend using Float mode to
  167.        multiply or divide.  Float mode allows you to place the
  168.        decimal and results will be rounded to the maximum capacity
  169.        of the calculator. If Dollar mode is active, the "D" box will
  170.        be hilighted.
  171.  
  172.    Tape Scroller (T):                   
  173.        Executes a sub-function allowing you to scroll through the tape 
  174.        listing that has "scrolled off the screen". It is limited to 500
  175.        previous entries.  The tape scroll buffer is cleared at startup 
  176.        and whenever "Over" (see below) is executed.                    
  177.  
  178.     Printer Toggle (P):
  179.        Toggles printer on and off.  Obviously this assumes you have
  180.        a printer and would like a tape of your activity.  Most line
  181.        feed type printers should work (don't use a laser).  There is
  182.        an error message built in if your printer is not ready to
  183.        print, but I have found that checking the availability of a
  184.        printer is not always reliable (funny switch settings, certain
  185.        ram and external buffers, etc.).  You'll just have to try it.
  186.        If the Printer is toggled on, the "P" box will be hilighted.
  187.  
  188.     Subtotal (S):
  189.        Subtotal does pretty much what you expect. It lists the current
  190.        running total without clearing it.
  191.  
  192.     Clear (C) and Backspace (<-):
  193.        Clear DOES NOT clear the running total.  Its only
  194.        function is to remove all numbers that you have entered
  195.        in prior to hitting an operator key.  Backspace removes
  196.        one number at a time. Hitting the Backspace key an
  197.        appropriate number of times will produce the same results
  198.        as Clear.
  199.  
  200.     Over (O):
  201.        Over is just a quick way to remove the screen listing and reset
  202.        the calculator.  It will also set the printer toggle off and clear
  203.        the tape scroller buffer.  The Dollar/Float toggle and colors will
  204.        return to their startup settings.  The memory registers stay intact.
  205.  
  206.     Quit (Q) or Esc or ` (backtic)  or  Shft/x:
  207.        You guessed it - EXIT.  There is NO WARNING like "are you sure?".
  208.        This isn't like a spreadsheet that you may have worked on for hours.
  209.        I figure that if your done, your done!  KDCalc has multiple exit options
  210.        due to various requests received during beta testing.
  211.  
  212.        See RESIDENT NOTES below for more information on the Shft/x exit.
  213.  
  214.     Memory Storage (M):
  215.        Memory will "grab" the current running total and execute a sub-
  216.        function allowing you to do a lot of things with the 9 memory
  217.        registers. It will only function after an operator has executed.
  218.  
  219.             [You should remember that if you have hit the Equal
  220.              key (ENTER) the current running total is 0.  There
  221.              is not a lot you can do with 0.  So use M after +,/,
  222.              *,S and sometimes -, C or R.]
  223.  
  224.        Upon execution, a window will pop up displaying the "grabbed"
  225.        total and asking you which memory register you want to work with.
  226.        Select 1 - 9 (or 0 to just return to the calculator).
  227.  
  228.        Assuming you choose 1 - 9, the current value of that register will
  229.        be shown and a series of options listed.  Select the option you
  230.        want. The result will be transferred to the selected register and
  231.        a summary of what has happened will be displayed for you.  At that
  232.        point, just hit any key to return to the calculator.  The stored
  233.        value can simply be used to verify another calculation, called again
  234.        and used in this sub-function, or Recalled into the calculator as
  235.        explained below.  If any memory register has a value, the "M" box
  236.        will be highlited.
  237.  
  238.     Recall Memory (R):
  239.        Recall will "grab" a stored memory value and transfer it to the
  240.        calculator based on the operation set by the current operator.  
  241.        It will only work after an operator has been issued and will have
  242.        no affect if the selected memory register value is 0.
  243.  
  244.        Upon execution, a window will pop up asking you which memory
  245.        register value to transfer.  The window will also show you the
  246.        current "inherent total" (running total of the calculator) and an
  247.        indication of what you are about to do to that "inherent total"
  248.        based on the current mathematical operator.  This indication is
  249.        significant because once you choose a register, the rest is 
  250.        automatic.
  251.  
  252.        This may sound complicated, and I guess it is (a little), but after
  253.        you try it a few times it should be clear.  The main thing to 
  254.        remember is that not only will a value be transferred, but the current
  255.        operator will also be issued.  This is intentional for the sake of
  256.        speed.  It saves a lot of keystrokes.  You can get the same results
  257.        by issuing an operator, keying the number you want by looking at
  258.        the memory register and then issuing another operator.
  259.  
  260.     Formula Generator (G):
  261.        The formula generator is a complete sub-function with its own help
  262.        screens and procedures.  It allows you to input a formula similar
  263.        to a spreadsheet cell.  This function was included mainly to assist
  264.        in calculations where the order of execution is important.  Example:
  265.        3 * 2 + 4 equals 10, but 3 * (2 + 4) equals 18.  See what I mean.
  266.  
  267.        (G)enerate will display a separate set of windows and be ready for 
  268.        input.  In Generate, H will scroll through 4 help panels, C will capture
  269.        any result and allow you to store it in the Memory function; Esc will
  270.        return you to the calculator.
  271.  
  272. RESIDENT NOTES (implemented by /M command parameter):
  273.  
  274.        When KDCalc is called via /M, a short message will be displayed telling
  275.        you that the load was successful, appx. amount of memory used and
  276.        the "Hot-Key" combination required to pop it up.
  277.  
  278.        After loading, hit the Hot-Key combination whenever you want to use
  279.        the calculator.  It has been tested over many of the commonly used
  280.        software programs.  However, this is still a TSR, and as such, will
  281.        undoubtedly be incompatible with some programs and other TSR's.  BE
  282.        WARNED.
  283.  
  284.        There are only two significant differences between the resident mode 
  285.        and the non-resident mode:
  286.  
  287.            (1) The resident version retains whatever you have done at all 
  288.                times. (The non-resident mode always starts from scratch.)
  289.            (2) A Shift/x (this actually ends up being a lowercase x because 
  290.                the CapsLock is on whenever you are in the calculator), 
  291.                will exit the calculator and "put" the last non-cleared
  292.                TOTAL at your cursor location.  You may have to press a key
  293.                to accept the value -- this seems to vary with software.
  294.                (Shft/x also exits from the non-resident mode, but does not
  295.                 transfer a number.)
  296.  
  297. REQUISITE DISCLAIMER and OTHER STUFF:
  298.  
  299.        Every reasonable attempt has been made to offer a fun product that
  300.        may be of some use and be "bug" free.  I (the author) can, however,  
  301.        offer no guarantees as to the suitability or use of this program.
  302.        Therefore (here we go)...
  303.  
  304.                THIS PRODUCT IS PROVIDED "AS IS" AND
  305.                WITHOUT WARRANTIES EXPRESS OR IMPLIED.
  306.                THE USER ASSUMES ALL RISK ASSOCIATED
  307.                WITH THE USE OF THIS PROGRAM.                          
  308.  
  309.        You may copy and distribute this program freely.  Please don't
  310.        charge for it and please provide this DOC file with it.
  311.  
  312.        Anyone who is interested, can send the author (me) $5.00 or so.
  313.             (Mainly, I'm curious to see if anyone is interested!)
  314.  
  315.                                                 David A. Befort
  316.                                                 KD Ranch Enterprises (c)
  317.                                                 Rt.3, Box 8080
  318.                                                 Bartlesville, Ok. 74003
  319.  
  320.  
  321.  
  322. P.S.   While I'm not a programmer by profession, I have written a few
  323.        other things -- usually because I can't find or buy precisely
  324.        what I'm looking for. You may see some of these floating around.
  325.  
  326.             [All of my programs begin with KD].
  327.  
  328.             KDQwik  - a small, easy word processor. Extremely straight
  329.                       forward for a beginner or an executive. (not under
  330.                       general release as of 4/26/89).
  331.  
  332.             KDGraph - a pull-down menu driven graphics package for EGA/VGA.
  333.                       It's fast and does some 3D stuff along with your basic
  334.                       bars,lines and pies.
  335.  
  336.             KDCalcG - an EGA/VGA graphics version of KDCalc.  Has a few less
  337.                       functions and no pop-up mode.
  338.  
  339.             KDLogic - a set of 5 brain teaser logic puzzles (HiQ,Minefield,
  340.                       Mastermind,Fifteen Squares and Towers). Program can
  341.                       made memory resident for quick pop up and down.
  342.  
  343.             KDPoker - There are a lot of good blackjack games, but I couldn't
  344.                       find a good, true rendition of the Video Poker machines
  345.                       that are now extremely popular in Las Vegas, Reno, etc.
  346.                       Two commercial versions I bought were awful.  This plays
  347.                       pretty much like the real thing.
  348.  
  349.             KDPokanl- This is kind of a companion program to KDPoker.  It has  
  350.                       two modes - one, a PLAY mode which will play much like   
  351.                       the games included in KDPoker. The other - ANALYSIS mode  
  352.                       which allows you to set up any hand, hold the cards you  
  353.                       want and draw to it repeatedly to help determine the best
  354.                       strategies to play video poker.
  355.  
  356.  
  357.